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NOSview Is an on-line documentation package for the KA9Q Network Operating System 
(NOS). First released In September 1991, NOSview Is a complete reference work describing I 
detail all of the commands to be found in the major NOS releases. This paper outlines iis 


main features, and how to get a copy. 


Introducing NOSVIEW 

Over the years, many documents have appeased on 
the networks describing various features of NOS, 
but much of that material is incomplete. Some of it 
is inaccurate, and, because it was written and edited 
by many hands, sometimes very misleading and 
inconsistent. 


My small contribution to the genre is NOSVIEW. In 
NOSVIEW I have attempted to pull together al! the 
available documentation and massage it into a 
consistent whole, 


The final product is almost 300 pages long, around 
20 percent being new material. All of the NOS 
commands are described in detail, and there is at 
least one example included with each command. 
There are also many examples of display outputs, 
showing the results of executing the commands. 


Consistency 

Because NOS contains software modules originating 
from several different sources, the associated 
documentation inevitably contains inconsistencies. 


For example, the words label and interface 
apparently describe different objects, whereas in 
actuality they are the same thing. On the other hand, 
the word address can have different meanings, 
depending on the command. 


A lot of effort has gone into NOSVIEW to eliminate 
these inconsistencies. Command parameter names 
are now consistent throughout. Callsigns in the 
examples follow a set pattern: calls for NOS stations 
are in the NS9xx.x series, vanilla AX.25 stations are 
AX9xxx, NET/ROM station:; are NR9.xxx, and so on. 
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Also, to distinguish between [P hostnames and 
AX.25 callsigns hostnames are shown in lower ¢:s 
(ns9abc), whereas AX.25 callsigns are in upper cas: 
(NS9JABC-S). 


These seemingly simple rules make a tremendou-. 
difference to the readability of the documentatior 
There is now no doubt about whether a parameter 
should be an IP host-name or an AX.25 callsign, < 

whether you need an IRQ number or an interrur: 
vector address, and so on. 


NOSview On-line 

But this is only half the story, The real power o! 
NOSVIEW comes into its own when used with VIEW 
a public domain file viewer included wi:: 
NOSVIEW. View lets you hot-kev to the NOSVIEW 
documentation without breaking out of NOS. 
providing instant on-line he!p whenever you need to 
know what to do next. 


Figure | shows an example of the ViEW screen. Ti: 
take full advantage of VIEW, NOSVIEW is supplic.' 
as a set of over 90 individual help files, one file te 
each NOS command. This provides immediit«: 
access to the command of interest, saving time ar ‘ 
effort when searching for detailed infcrmation. 


A further benefit of supplying NOSVIEW 
individual files rather than one monolithic documer 
is that you can place the files in your NOS public 
directory. Then when someone iogs into you 
system, they can downtcad selected NOSVIEw 
information in manageable pieces, rather th: 
saturate the network for Hours on end trying i 
download one enormous file. 


Load file: V:*.* 


r— FILES —4 


route add default tncO 
route add ns9jim tncOd 


route add 192.3.4.5 s1l0 


(no gateway 
point-to-p| POP 


NRSTAT 
PARAM 


route addprivate <target _host>[/bits] | default <i] PWD 
[<gateway_host> 


[<metric>] 


The ‘route addprivate'’ command is identical to ‘ro 
that it also marks the new entry as private; it wi 


included in outgoing RIP updates. 


>> Example: 


The ‘route drop' 
packet arrives for th 
effect, it will be used. 


route drop <target_host>[/bits] 


command deletes an entry from the 
deleted address and a defau 


route addprivate region41/24 ns9bob 


SCCSTAT 
SESSION 
SHELL 
SMTP 
SOCKET 
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Fig 1: On-line NOS documentation with NOSVIEW. 


There is a separate help file for each NOS command, selected from the pop-up 
FILES menu. 


The NOS Get-Away Special 

Yet another feature of NOSVIEW is that it contains a 
complete working set of NOS software, dubbed 
NOSGAS — the NOS Get-Away Special. NOSGAS 
incorporates a complete set of supporting files (such 
as AUTOEXEC.NOS, FTPUSERS and so on) which 
you can use on your system. The templates are 
accompanied by full descriptions of their formats, 
plus warnings about the “gotchas” which can cause 
lots of frustration if you are unaware of them. 


All you have to do is edit these templates to match 
your system (by modifying callsigns, etc), and you 
have a_ ready-made environment to try out NOS. 


How to get NOSVIEW 

The latest release of NOSVIEW is version 244; i.e. 
released in 1992, week 44.By now, NOSVIEW 
should be available on the major telephone bulletin 
boards worldwide, and also on ucsd.edu in directory 
hamradiolpacketltcpipldocs. Look for the files 
NOSVIEW.ZIP and NOSVW244.ZIP. 


Alternatively, you can get a free copy by mailing a 
DOS-formatted diskette (any size except 360K) and 
return mailer to: Ian Wade, 7 Daubeney Close, 
Harlington, Dunstable, Beds, LUS 6NF, United 
Kingdom. 


Please enclose return postage as follows: 


United Kingdom: UK postage stamps 


Europe: 3 IRCs 
The Americas: 7IRCs 
Rest of World: 9 IRCs 


(Any unused IRCs will of course be returned). 


NOSINTRO: The book 

NOSVIEW is an advanced reference document 
intended mainly for people who have already got 
NOS up and running. Beginners will probably find 
it heavy going, but may be interested to know that 
my new book on NOS — NOSINTRO -- is (at last!) 
ready. Full order details are included with the 
NOSVIEW package. 
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